Deprecate gdk_visual_get_colormap_size

Since we don't have API for colormaps anymore, this is not
a useful function.

diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index 82305fc90afd6ff50033724a01c3e72225c29c83..efdeac730220f85a8770cd5f3f2da2981be93bee 100644 (file)
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -302,6 +302,7 @@ gdk_visual_get_depth (GdkVisual *visual)
  * @visual: A #GdkVisual.
  *
  * Returns the byte order of this visual.
+ *
  * The information returned by this function is only relevant
  * when working with XImages, and not all backends return
  * meaningful information for this.
@@ -326,9 +327,14 @@ gdk_visual_get_byte_order (GdkVisual *visual)
  *
  * Returns the size of a colormap for this visual.
  *
+ * You have to use platform-specific APIs to manipulate colormaps.
+ *
  * Returns: The size of a colormap that is suitable for @visual.
  *
  * Since: 2.22
+ *
+ * Deprecated: 3.22: This information is not useful, since GDK does not
+ *     provide APIs to operate on colormaps.
  */
 gint
 gdk_visual_get_colormap_size (GdkVisual *visual)
@@ -343,6 +349,7 @@ gdk_visual_get_colormap_size (GdkVisual *visual)
  * @visual: a #GdkVisual
  *
  * Returns the number of significant bits per red, green and blue value.
+ *
  * Not all GDK backend provide a meaningful value for this function.
  *
  * Returns: The number of significant bits per color value for @visual.

diff --git a/gdk/gdkvisual.h b/gdk/gdkvisual.h
index 84337aaddc0cb7d5fe77517e20f896e719f41d5e..a401f1f4892e418b85d96ba9944902618c215dc4 100644 (file)
--- a/gdk/gdkvisual.h
+++ b/gdk/gdkvisual.h
@@ -117,7 +117,7 @@ GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_depth               (GdkVisual *visual);
 GDK_DEPRECATED_IN_3_22
 GdkByteOrder  gdk_visual_get_byte_order          (GdkVisual *visual);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 gint          gdk_visual_get_colormap_size       (GdkVisual *visual);
 GDK_DEPRECATED_IN_3_22
 gint          gdk_visual_get_bits_per_rgb        (GdkVisual *visual);